home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 November / macformat-043.iso / mac / Shareware Plus / Developers / OpenStack Rinaldi Collection / openstack-rinaldi-lib / Promptoid 1.5 (US) / Promptoid 1.5 (US).rsrc / HELP_5635 next >
Encoding:
Text File  |  1996-01-09  |  3.2 KB  |  78 lines
  1.  
  2.  
  3.                                              Promptoid 1.5
  4.  
  5.                                           par Frédéric RINALDI
  6.  
  7. DESCRIPTION
  8.   Promptoid allows to display a prompt dialog during any lengthy process. Dialog's width is set according to prompt string.
  9.  
  10. Caution
  11.   This XCMD is the same as Prompt. Promptoid is for HC 2.0, while Prompt is for HC 1.2.
  12.    If you already use Prompt in stacks to be converted in HC 2.0 format, just use the compatibility script below so that no script changes will be necessary while the calling convention has changed.
  13.  
  14.    Compatibility script has changed with Promptoid 1.2.
  15.  
  16. SYNTAX
  17.           Promptoid [<message>[<ICON name or id>[,<VLoc>[,<width>]]]
  18.  
  19. PARAMETERS
  20.    All parameteres are optional.
  21.  
  22.    <message> is the string to be displayed.
  23.  
  24.    <ICON name or id> is the name or ID of any ICON resource to be displayed in the dialog.
  25.  
  26.    <VLoc> is an integer giving the vertical position of the dialog according to the card window. Default is centered.
  27.  
  28.    <width> is an integer giving teh width of the dialog.
  29.  
  30.    Using "!", "?" and "=" as first parameter will return an online help (resp. copyright, syntax and output).
  31.  
  32. USING
  33.    If <message> param is omitted, default dialog's width will be 300 pixels.
  34.  
  35.    If <VLoc> param is omitted, the dialog will be centered on the card.
  36.  
  37. PROPERTIES
  38.    Like any XWindow, Promptoid has properties that can be get and set thru HyperTalk. 
  39.            properties of window "Promptoid"
  40.  
  41. will return an item list of all allowed properties :
  42.  
  43.      • icon      : id and name of displayed ICON resource, empty if none
  44.      • loc        : dialog's loc according to card window
  45.      • visible  : dialog's display state
  46.      • text      : prompt shown in the dialog
  47.      • vLoc     : dialog's vertical loc according to card window
  48.      • width    : dialog's width
  49.  
  50. ERRORS
  51.    If an error occurs, Promptoid can return :
  52.      "Error : Promptoid already displayed"
  53.      "Error : Bad coordinate"
  54.      "Error : Bad width"
  55.      "Error : Unable to create XWindow"
  56.      "Error : XWindows not implemented"
  57.  
  58. HISTORY
  59. 1.5                                                                                         08/11/92
  60. • Dialog centered on screen if HC window not visible
  61. • Other minor enhancements
  62.                                                                                          
  63. 1.3                                                                                         11/18/91
  64. • Fixed visual aspect bug under System 7
  65.  
  66. 1.2                                                                                         08/16/91
  67. • Added "=" online help param
  68. • Added icon param and property
  69. • Dialog's width no more adjusted with set text…
  70. --------------------------------------------------------------------
  71.    All externals included in this stack are FreeWare and may be used in non-commercial software provided the following notice is visibly present :
  72.  
  73.                  Promptoid XCMD, © Frederic Rinaldi, 1989…1993.
  74.  
  75.    Free for non-commercial use. Use in commercial software subjected to prior acknowledgement and licensing from the author, reachable at the following network addresses:
  76.  
  77. AppleLink: RINALDI1   CalvaCom : FR10    Compuserve : 71170,2111
  78.                Internet : RINALDI1@APPLELINK@APPLE.COM